Blender Documentation Volume II - Reference Guide: Last modified March 29 2004 S68
<<< Previous	Python API Reference	Next >>>

Module Object

The Blender.Object submodule

This module provides access to the Object Data in Blender.

Example:

 import Blender
 scene = Blencer.Scene.getCurrent ()   # get the current scene
 ob = Blender.Object.New ('Camera')    # make camera object
 cam = Blender.Camera.New ('ortho')    # make ortho camera data object
 ob.link (cam)                         # link camera data with the object
 scene.link (ob)                       # link the object into the scene
 ob.setLocation (0.0, -5.0, 1.0)       # position the object in the scene

 Blender.Redraw()                      # redraw the scene to show the updates.

Classes
`Object`	This object gives access to generic data from all objects in Blender.

Function Summary
á	`Get(name)` Get the Object from Blender.
á	`GetSelected()` Get the selected objects from Blender.
á	`New(type, name)` Creates a new Object.

Function Details

Get(name=None)

Get the Object from Blender.

Parameters:

name - The name of the requested Object.

áááááááááá (type=string)

Returns:

It depends on the 'name' parameter:

(name): The Object with the given name;
(): A list with all Objects in the current scene.

Example 1:

The example below works on the default scene. The script returns the plane object and prints the location of the plane:

 import Blender

 object = Blender.Object.Get ('plane')
 print object.getLocation()

Example 2:

The example below works on the default scene. The script returns all objects in the scene and prints the list of object names:

 import Blender

 objects = Blender.Object.Get ()
 print objects

GetSelected()

Get the selected objects from Blender. If no objects are selected, an empty list will be returned.

Returns:

A list of all selected Objects in the current scene.

Example:

The example below works on the default scene. Select one or more objects and the script will print the selected objects:

 import Blender

 objects = Blender.Object.GetSelected ()
 print objects

New(type, name='type')

Creates a new Object.

Parameters:

type - The Object type: 'Armature', 'Camera', 'Curve', 'Lamp', 'Mesh' or 'Empty'.

áááááááááá (type=string)

name - The name of the object. By default, the name will be the same as the object type.

áááááááááá (type=string)

Returns:

The created Object.

Example:

The example below creates a new Lamp object and puts it at the default location (0, 0, 0) in the current scene:

  import Blender
  
  object = Blender.Object.New ('Lamp')
  lamp = Blender.Lamp.New ('Spot')
  object.link (lamp)
  scene = Blender.Scene.getCurrent ()
  scene.link (object)

  Blender.Redraw()

<<< Previous	Home	Next >>>
The Scene object	Up	Class Object